==================================================
 	Melissa name Object API for Windows 	 
==================================================


************
INTRODUCTION
************

This file describes how to set up and use the java wrapper code with Melissa DATA's Name Object.


*************
PREREQUISITES
*************
An installation of a Java Developer's Kit 1.4.2 or later or an equivalent product.

The Melissa DATA Name Object library and data files installed.

	Library = mdName.dll
	Data Files = mdName.dat and mdName.cfg.




These files are installed automatically if you run setup.exe from the root of the DQT Suite DVD. 
You will need to know the location of these files.


**********************
Wrapper compatibility
**********************

If the provided pre-compiled wrappers are not compatible with your environment, the necessary files for compilation can be found in the 'interfaces' folder of the object's main directory.



*********
Demo Mode
*********
Please contact your sales representative to obtain a free 30-day license to use Name Object.  After
30 days, the Object must be purchased before continued usage. Please call 1-800-MELISSA ext. 3 for
more information.



*******************
Running the Scripts
*******************
Open CreateJarFile.bat in wordpad. Put the path to your Java bin directory to the Java_Dir variable. 

	Example: set JAVA_DIR=c:\Program Files\Java\jdk1.6.0_01\bin

Open RunSample.bat in wordpad. Put the path to your Java bin directory to the the Java_Dir variable.

	Example: set JAVA_DIR=c:\Program Files\Java\jdk1.6.0_01\bin


Open NameSample.java, and set the Name Object License string (that you receive from your Melissa Data sales representative) in place of DEMO, and set the directory of the Name Object data files.
  
		public static String the_license = "DEMO";
  		public static String datafile_dir = "C:\\Program Files\\Melissa Data\\DQT\\Data";

Double Click on CreateJarFile.bat. This should create a file called mdName.jar. This file must be 
created successfully to use the Java wrapper.

Copy mdName.dll into the directory with RunSample.bat and Double Click on RunSample.bat. 
This will compile mdNameExample.java and run the sample program. 


***********
Sample Code
***********

mdNameExample.java contains sample code for using Name Object. If you make changes to mdNameExample.java, 
you must execute RunSample.bat again to recompile the code.



*******
Updates
*******

The wrapper normally does not need to be rebuilt for DQT Suite updates. They are the connection 
between Name Object (mdName.dll) and the java client code. As long as there are no method naming 
changes or deletions in Name Object, the wrapper does not need to be changed. For newly added methods, 
the wrapper also does not need to be rebuilt unless you want to use the new methods. 

*****
Notes
*****

The source code and a bat script to compile mdNameJavaWrapper.dll is supplied in the Source directory. 
Since mdNameJavaWrapper.dll is already supplied, you do not need to use this unless you have to 
recompile mdNameJavaWrapper.dll. Instructions to compile are in CreateDll.bat and the readme.txt in the 
Source folder. Please read them before executing the bat file. 


Link Error
==========
If you get a java.lang.UnsatisfiedLinkError in mdName when running the program,
it is most likely because mdName.dll cannot be found. The easiest solution is
to add the file's location to your PATH environment variable or copy mdName.dll to
this directory.

String.format
=============
Older versions of Java (before 1.5) don't have the String.format() method that
is used in the example. To run the example, you need to convert these calls to
unformatted string output.